package com.mall.mapper;

import com.mall.entity.Product;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 商品数据访问层
 * 
 * @author Mall Team
 */
@Mapper
public interface ProductMapper {
    
    /**
     * 插入商品
     */
    int insert(Product product);
    
    /**
     * 根据ID删除商品
     */
    int deleteById(Long id);
    
    /**
     * 更新商品
     */
    int updateById(Product product);
    
    /**
     * 根据ID查询商品
     */
    Product selectById(Long id);
    
    /**
     * 根据ID查询商品（包含分类信息）
     */
    Product selectByIdWithCategory(Long id);
    
    /**
     * 分页查询商品列表
     */
    List<Product> selectPage(@Param("offset") Integer offset, 
                            @Param("limit") Integer limit,
                            @Param("keyword") String keyword,
                            @Param("categoryId") Long categoryId,
                            @Param("brand") String brand,
                            @Param("status") Integer status);
    
    /**
     * 查询商品总数
     */
    Long selectCount(@Param("keyword") String keyword,
                    @Param("categoryId") Long categoryId,
                    @Param("brand") String brand,
                    @Param("status") Integer status);
    
    /**
     * 根据分类ID查询商品
     */
    List<Product> selectByCategoryId(Long categoryId);
    
    /**
     * 根据品牌查询商品
     */
    List<Product> selectByBrand(String brand);
    
    /**
     * 查询上架商品
     */
    List<Product> selectOnShelfProducts();
    
    /**
     * 更新商品状态
     */
    int updateStatus(@Param("id") Long id, @Param("status") Integer status);
    
    /**
     * 更新商品库存
     */
    int updateStock(@Param("id") Long id, @Param("stock") Integer stock);
    
    /**
     * 扣减库存
     */
    int reduceStock(@Param("id") Long id, @Param("quantity") Integer quantity);
    
    /**
     * 批量删除商品
     */
    int deleteBatchByIds(@Param("ids") List<Long> ids);
    
    /**
     * 搜索商品（支持模糊搜索）
     */
    List<Product> searchProducts(@Param("keyword") String keyword,
                                @Param("offset") Integer offset,
                                @Param("limit") Integer limit);
    
    /**
     * 获取搜索商品总数
     */
    Long searchProductsCount(@Param("keyword") String keyword);
    
    /**
     * 获取推荐商品
     */
    List<Product> selectRecommendProducts(@Param("limit") Integer limit);
    
    /**
     * 获取同分类相关商品
     */
    List<Product> selectRelatedProducts(@Param("categoryId") Long categoryId,
                                       @Param("excludeId") Long excludeId,
                                       @Param("limit") Integer limit);
    
    /**
     * 获取热销商品
     */
    List<Product> selectHotProducts(@Param("limit") Integer limit);
    
    /**
     * 检查商品名称是否存在
     */
    boolean existsByName(String name);
    
    /**
     * 根据分类ID统计商品数量
     */
    Long countByCategoryId(Long categoryId);
}